June 14 2024:

Fixed an issue when Choose Planets and Boss Rush Mode was on, as the player would always end up on Corneria.

June 13 2024:

Fixed a softlock on Sector X if ending in the warp zone when Quick Score Screens was on.

April 7 2024 (Hot Fix):

Fixed a crash when creating a checkpoint again (debug mode).
Fixed a crash on Corneria when Quick Score Screens was on again.
Removed sound from speed up debug mode buttons.

April 7 2024:

Fixed a crash when creating a checkpoint (debug mode).
Fixed crashes on Meteo and Corneria when Quick Score Screens was on.

April 4 2024:

Fixed a bug when the player went to the special stage and exited, the score and other player statistics would not be kept.

January 25 2024:

Fixed a crash on MacBeth if Quick Score Screens was on.
Fixed a bug in Boss Rush Mode where Aquas wouldn't start out on the boss.

December 16 2023:
Potential fix for a crash on Zoness exclusive to hardware.

For testing on hardware to see if this crash is fixed: Enable "Choose Planets" option and enable various other settings then choose Zoness in the map screen. Crash would happen sometime before the checkpoint.

December 4 2023:
Fixes:
* Small logic bug if the player retired on the planet screen in Boss Rush Mode.
* Bug in Marthon Mode after completing Venom 1 once, it would go back to the same level again.

Minor additions:
* Z + R + C-Down when Debug Mode is on restores health and wings.

September 20 2023:
Added:
*Extra Star Wolfs now has one extra wolf enemy for Sector Z, Y and Venom 2 Andross battle on Expert. Venom 2 Andross battle also has Katt and Bill to aid you.

Fixes:
*Fixed timer bugs in Boss Rush Mode.
*Fixed a bug in Fortuna if Extra Star Wolfs was on making the level not possible to complete.
*Fixed Boss Rush Mode logic checks not going to correct levels in certain cases.

September 15 2023:
Added:
New Bonus Stage added. If this is set to random ("RAN"), the player has a 50-50 chance of entering this stage after completing Bolse or Area 6. If set to the "ON" state, the player will need to get a set amount of score by the end of Area 6 or Bolse. The scores needed are listed below:

*Regular game or expert mode score needed (no special modes active): 1000
*Only Marathon Mode: 2500
*Only Boss Rush Mode: 50000
*Boss Rush Mode and Marathon Mode: 85000

This stage is basically a free for all with all wingmen available for assisting Fox along with Rob. In set intervals, Rob will ready a special bomb. When this is ready, text will be displayed above the mini map. Press L to deploy it. Certain enhanced Wolf ships may appear after getting a set score. These will be a slightly enhanced version of typical Wolf enemies. Destroying them will yield 50+ hits. 100+ hits on Expert with also slightly more tweaked AI and health.

This stage can also be selected using "Choose Planets".

September 11 2023:
Added:
* Re-added Boss Rush Mode with additions. Now contains logic for random planets and Marathon Mode. If you would like to randomize planet bosses, leave random planets on. If Marathon Mode is on, it will play all levels in order that Marathon Mode does. Also contains a new item to obtain in the item menu granting invulnerability for set time.
* Misc debug mode logic.

Fixes:
* Minor Random Item logic.

While Boss Rush Mode currently has not undergone extensive testing, two patches are provided. One with debug mode automatically on, and one regular patch. For a list of debug mode cheats, see "Menu Options Explanations.txt".

September 4 2023:
Added:
* Re-added Marathon Mode. Plays all planets starting from Training Mode to blue path, yellow path to red path.
* Re-added Extra Star Wolfs with additions. They now appear at the Sector Y boss, in Sector Z after the first missile spawns, and in the Andross 2 brain fight. Also will always appear on Katina and Bolse.

Fixes:
* Fixed a crash on hardware if Random Map Colors was on in Zoness and Aquas by disabling this option on those planets as it is unclear what the crash is.

Please note that not all options are currently coded in as this project was re-written from scratch. If you would like to play with other modes that are not present here, please use the April 23 2022 version for now.

July 24 2023:

Added:
* Re-added Random Death Items.

Fixes:
* Fixes an old bug if bombs was chosen as a death item on Zoness and if a checkpoint was a death item on a Landmaster stage and collected, the player would get softlocked.
* Small oversight of planet ordering logic (in map screen).
* Allow same planets when off should work correctly now.

Please note that not all options are currently coded in as this project was re-written from scratch. If you would like to play with other modes that are not present here, please use the April 23 2022 version for now.

March 6 2023:
Entire project re-written from scratch and is now open source. Not all options are currently coded in. If you would like to play with other modes that are not present here, please use the April 23 2022 version for now.

Added:
Endurance Mode: A timer is present at the top of the screen. You will instantly game over if it reaches zero. Score points to increase the timer. Below is how the scoring for this mode works.

*If collected a bomb or used a bomb, subtracts 100 points from the timer. 160 if on expert.
*If the player has a dual laser, add 160 to the kill made. 140 on expert.
*If the player has a hyper laser, add 200 to the kill made. 180 on expert.
*When a kill is made, it will multiple that value by 45. 40 on expert. The more kills made in a single frame, the higher the multiplier.
*When the player completes a level, based on if the timer is green, yellow, or red, it will add these amounts to the score:
Green 550 (300 expert), Yellow 450 (200 expert), Red 100 (0 expert)

PROTECT THE TARGETS: Starts on Katina where you must protect Bill and Katt from dying from swarms of enemies (and yourself). If the timer reaches 15000 without both targets lost, the player will win the stage. Normal mode starts you out with 5 bombs and hypers. Expert is default items.

April 23 2022:

Added:
Trippy Map Colors.
Spinning Fox (was a part of Drunk Mode before).

Fixes:
The player now properly loses their score if they fail to take out a missile on Sector Z in Boss Rush mode.
If the player died in the second part of the tunnels after defeating Andross brain, they would be taken to a glitched fight of Andross again in Boss Rush Mode.

April 18 2022:

Added:
SFX now plays when moving the cursor in the randomizer menu.
Boss Rush Mode now has an item menu in the pause menu when pressing L button. Players can spend their points for items.

Adjustments:
Removed the spin effect on Fox when in Drunk Mode.
Removed powerups from Boss Rush mode.
Boss Rush Mode's Sector Z missiles spawn faster, as well as spawning straight to Venom when in the tunnels.

Fixes:
When Extra Star Wolfs is enabled, they would not respawn on Bolse.

April 11 2022:

Added:
Light purple engine color for Random Engine Colors.

Fixes:
+3 hits was storing to a wrong address to the fake Star Wolf in Marathon mode.
Crash when collecting a checkpoint due to wrong logic in Random Death Item.

April 10 2022:

Added:
Random Death Item.
End credits is now among the random music option.

April 8 2022:

Adjustments:
The fake Star Wolf in Marathon mode's training level now rewards the player with a +3 hit for killing them.

April 7 2022:

Added:
Boss Rush Mode (Initial version - more functionality later).
Additions to Debug Cheats (See Menu Options.txt for a list).
Added Andross, General Pepper, and James to Katina's random portrait function.
Added Drunk Mode.

Fixes:
The text "DEBUG CHEATS" no longer displays in-game if the option is off.
End screen no longer prematurely ends due to new end screen logic.
Random Planets now works currently again (seemed to only affect hardware players).
Planets the player has played should correctly be displayed in the end credits now.

Adjustments:
Version display in main menu.
When randomizer logic does a soft reset, the "Lylat Wars" intro screen is skipped for a more seamless transition.

Code Changes:
NOP'd checks at 0x804027ec / 0x804027f0 for soft resetting as they weren't needed.
Adjustments to in-game text rendering function.
Added Boss Rush Mode logic to end screen randomizer function to calculate planet scores.
Adjusted intro scene logic to accommodate ordering of planets played / completed.

March 21 2022:

Added:
Debug Cheats
Text in-game if the player has Debug Cheats on.
Text in the planet screen if the player has Choose Planets on.

Fixes:
Fixed a crash on hardware when selecting Extra Star Wolfs.
Fixed a bug in Choose Planets where the end screen would stay on the screen.

Adjustments:
Debug cheats is off by default now.
Marathon mode now starts in Training mode either from entering Training mode, or the planet screen.

Code Changes:
Marathon mode logic change.

March 17 2022:
Added:

Starting Bomb Count.
Starting Lives.
Starting Lasers.
Extra Star Wolfs.
Choose Planets.

Adjustments:

One Hit Kill has been changed to One Hit KO to better reflect that the player dies in one hit.

Fixes:

One Hit KO logic change to fix a rare bug.
Retrying a level with random expert or random warp chance wouldn't properly understand the last state these values were in.

Code Changes:

Removed Katina / Bolse Star Wolf Marathon Mode logic and put it as a separate option.
Added planet end screen logic for Choose Planets.
Added planet intro logic for Choose Planets.

Known Issues:

The last planet when random planets is on will generally not report the correct planet in the score entry scene after the credits.

Beta 26:
Minor adjustment to Macbeth end scene timer for warping to Training Mode (Marathon Mode only).
Added random dialog (all voice and text lines are random).

Beta 25:
Fixed MacBeth first path train boss error in Marathon Mode where the player would not be taken to the correct planet (again, whoops).
Fixed an error if Random Expert / Warp Chance was on and the player retried at the planet screen, the settings wouldn't be correct.
Allow Same Planets when off now works correctly.
Added a button combination to return to the title screen if needed (D-Pad Up + C-Up + Start).

Beta 24:
Fixed MacBeth first path train boss error in Marathon Mode where the player would not be taken to the correct planet.
Fixed Star Wolf not spawning on Bolse in Marathon mode. If the player played the entire intro sequence to the planet, Star Wolf would never spawn.
Moved Star Wolf spawn on Katina to second phase of the level (only for Marathon mode).

Beta 23:
Slightly different map / reflection color RNG for reflection and map colors.
Added Random Portraits.

Beta 22:
Fixed hangs at the main menu / randomizer menu.
Fixed Marathon Mode Sector Y incorrect loading of bombs, lasers, lives, and scores.
Fixed a potential crash after getting a game over then starting a game again.
Small adjustment to randomizer menu text.
Added Star Wolf on Bolse when in Marathon Mode.
Initial progress on random portraits (not functional yet).

Beta 21:
Custom menu font is now bigger and should appear better on console.

Beta 20:
Fixed retrying in the map screen. This would cause the last planet to randomize when it shouldn't.

Beta 19:
Bug fix.
Added One Hit Kill mode.

Beta 18:
Added Rainbow Bombs.
Fixed Allow Same Planets when off (hopefully).

Beta 17:
Implaneted a randomizer menu. Press L at the main menu to open.

Beta 16:
Implaneted random music.
Implaneted random ambient map colors.

Beta 15:
Fixed a crash.
Implaneted Marathon Mode.

Beta 14:
Implaneted skip stright into planets from map select screen.

Beta 13:
Implanted random item drops.

Beta 12:
Implanted random engine colors.

Beta 11:
No same planet order implanted (automatically disabled for now).
Unlock all medals and expert mode (automatically enabled for now).
Random chance at starting in a warp space implanted (Sector X, Meteo only. Automatically enabled for testing).
Random chance at starting in expert mode implanted (automatically enabled for now).

Beta 10:
Fixed a crash.

Beta 9:
Fixed correct planet orders taken in map selection screen.

Beta 8:
Added correct planets taken in map selection screen.

Beta 7:
Re-coded ASM.
Improved planet RNG.

Beta 6:
Initial expansion pack test. Same features as Beta 5.

Beta 5: 
Fixed retry on the map screen.
Randomizer now continues after completing the game once.